home *** CD-ROM | disk | FTP | other *** search
/ Hot Metal Pro 4.0 / Hot Metal Pro 4.0.iso / HMPTools / DataSpot / README.TXT < prev    next >
Encoding:
Text File  |  1997-09-08  |  30.8 KB  |  638 lines
  1. =============================================================
  2.      Copyright (C) 1995-1997, DTL Data Technologies Ltd.
  3.                      All Rights Reserved.
  4. =============================================================
  5.  
  6. Updated: 9 July, 1997
  7.  
  8. Contents:
  9.  
  10.    o What Is DTL's DataSpot
  11.    o System Requirements
  12.    o Installing DataSpot
  13.    o Configuring Web servers
  14.    o Configuring the HoTMetaL Pro 4.0 Editor
  15.    o Running DataSpot
  16.    o Troubleshooting
  17.    o Improving Publisher Performance
  18.    o Contacting DTL
  19.  
  20. =============================================================
  21.                DTL DataSpot 1.2 (Windows NT & Windows 95)
  22. =============================================================
  23.  
  24.   DTL's DataSpot is a product for plain-language database search on the 
  25. Internet. DataSpot enables a data provider to publish large heterogeneous
  26. databases on the Internet or Intranet easily and efficiently.
  27.  
  28.   The DataSpot Publisher enables the data provider to create a single, 
  29. integrated DataSpot database from heterogeneous data sources, including external
  30. knowledge sources such as a thesaurus. The DataSpot Query Server 
  31. conducts the associative search and navigation process. End users invoke the 
  32. server transparently by issuing plain-language queries from a standard Web 
  33. browser such as Netscape's Navigator or Microsoft's Internet Explorer.
  34.  
  35.   DTL DataSpot software is subject to the terms detailed in the license agreement
  36. accompanying it.
  37.  
  38. =============================================================
  39.                      System Requirements
  40. =============================================================
  41.  
  42. Before installing DTL DataSpot make sure your system has the following:
  43.  
  44. * 32 MB of free memory (minimum)
  45.  
  46. * 40 MB of available disk space (minimum)
  47.  
  48. * Pentium or Pentium Pro processor
  49.  
  50. * Windows NT 3.51 or higher, or Windows 95
  51.  
  52. * To allow users to access the DataSpot Server across the Internet you
  53.   must also have a direct Internet connection and related software.
  54.  
  55. * See "Installing DataSpot" below for other required or optional software
  56.   that should be installed prior to installing DataSpot.
  57.  
  58. =============================================================
  59.                      Installing DataSpot
  60. =============================================================
  61.  
  62. Before installing DataSpot, you should install the following software packages:
  63.  
  64.   - To use the DataSpot Query Server, you should install a Web Server. DataSpot
  65.     currently works with either the Microsoft Internet Information Server 
  66.     (Versions 1.0, 2.0 or 3.0) or Microsoft Personal Web Server (Version 1.0)
  67.     or Netscape Enterprise Server (Versions 2.0 or 3.0) or FastTrack Server
  68.     (Version 2.0) or any other server that supports CGI, including ZBSoft's
  69.     ZBServer Pro. During the DataSpot installation you will be asked to
  70.     designate Web server(s) that will be automatically configured to work with
  71.     DataSpot. You can also configure a Web server manually by following the
  72.     instructions in "Configuring Web Servers" below.
  73.  
  74.   - If you want to use the HoTMetaL Pro 4.0 HTML editors to edit DataSpot
  75.     template files then you need to install one or both of them so that during
  76.     the DataSpot installation they will be automatically configured to work with
  77.     DataSpot. You can also configure these editors manually by following the
  78.     instructions in "Configuring the HoTMetaL Pro 4.0 Editor" below.
  79.  
  80.   - If you plan to use DataSpot Publisher with ODBC data sources, then
  81.     you need to install the corresponding ODBC drivers.
  82.  
  83. * Installation: to install DataSpot run the setup.exe file. For more
  84.   information, or if you experience any problems, see "Installation Notes"
  85.   below.
  86.  
  87. * Uninstallation: to uninstall DataSpot, do the following: if you are using the
  88.   Windows 95 Explorer shell, run "Add/Remove" programs from the Control Panel and
  89.   select to remove DataSpot. If you are using the Windows NT Program Manager, 
  90.   double click on the "Uninstall" icon in the DTL group.
  91.   We recommend that you first read "Uninstallation Notes" below.
  92.  
  93. * Directory Structure
  94.  
  95. The installation creates a directory tree with the following structure:
  96.  
  97. +--DTL
  98.     |
  99.     +--PROGRAM\
  100.     |
  101.     +--SAMPLE\
  102.     |
  103.     +--HELP\
  104.     |
  105.     +--DOC\
  106.     |
  107.     +--DEFAULT.HTM
  108.     |
  109.     +--README.TXT
  110.     |
  111.     +--LICENSE.TXT
  112.     |
  113.     +--INSTALL.LOG
  114.  
  115. The PROGRAM subdirectory contains the DataSpot executable files.
  116. The SAMPLE subdirectory contains sample DataSpot applications.
  117. The HELP subdirectory contains online help files.
  118. The DOC subdirectory contains online documentation files, such as user manuals.
  119.  
  120. The DEFAULT.HTM file defines the default first page seen by a user.
  121. The README.TXT file contains this text.
  122. The LICENSE.TXT file contains the license agreement.
  123. The INSTALL.LOG file contains information about the installed version.
  124.  
  125. The installation also installs or updates system files needed by the DataSpot
  126. programs, including DLLs, OCXs etc. Below is a list of these files (for
  127. a typical installation):
  128.  
  129.     File                 Default Directory on 
  130.                     Windows NT          Windows 95
  131.     ============================================================
  132.     COMCTL32.OCX    \winnt\system32     \windows\system
  133.     COMDLG32.OCX    \winnt\system32     \windows\system
  134.     CTL3D32.DLL     \winnt\system32     \windows\system
  135.     DAO2532.TLB     \winnt\system32     \windows\system
  136.     DAO3032.DLL     \winnt\system32     \windows\system
  137.     GAUGE32.OCX     \winnt\system32     \windows\system
  138.     GRID32.OCX      \winnt\system32     \windows\system
  139.     MFC40.DLL       \winnt\system32     \windows\system
  140.     MFC42.DLL       \winnt\system32     \windows\system
  141.     MSGBLST32.OCX   \winnt\system32     \windows\system
  142.     MSJINT32.DLL    \winnt\system32     \windows\system
  143.     MSJT3032.DLL    \winnt\system32     \windows\system
  144.     MSJTER32.DLL    \winnt\system32     \windows\system
  145.     MSLT3032.DLL    \winnt\system32     \windows\system
  146.     MSRD2X32.DLL    \winnt\system32     \windows\system
  147.     MSSTKPRP.DLL    \winnt\system32     \windows\system
  148.     MSVBVM50.DLL    \winnt\system32     \windows\system
  149.     MSVCR40D.DLL    \winnt\system32     \windows\system
  150.     MSVCIRT.DLL     \winnt\system32     \windows\system
  151.     MSVCRT.DLL      \winnt\system32     \windows\system
  152.     MSVCRT20.DLL    \winnt\system32     \windows\system
  153.     MSVCRT40.DLL    \winnt\system32     \windows\system
  154.     MSXB3032.DLL    \winnt\system32     \windows\system
  155.     MSWNG300.DLL    \winnt\system32     \windows\system
  156.     ODBC32.DLL      \winnt\system32     \windows\system
  157.     ODBCJI32.DLL    \winnt\system32     \windows\system
  158.     ODBCJT32.DLL    \winnt\system32     \windows\system
  159.     ODBCTL32.DLL    \winnt\system32     \windows\system
  160.     OLEAUT32.DLL    \winnt\system32     \windows\system
  161.     OLEPRO32.DLL    \winnt\system32     \windows\system
  162.     STDOLE2.DLL     \winnt\system32     \windows\system
  163.     THREED32.OCX    \winnt\system32     \windows\system
  164.     VB40032.DLL     \winnt\system32     \windows\system
  165.     VBAJET32.DLL    \winnt\system32     \windows\system
  166.     VBAR2232.DLL    \winnt\system32     \windows\system
  167.     VBDB32.DLL      \winnt\system32     \windows\system
  168.     VEN2232.OLB     \winnt\system32     \windows\system
  169.  
  170.  
  171. * Installation Notes
  172.  
  173.   Subject to the license(s) you purchased you may choose to install a DataSpot
  174. System for Development or for Production. The Development DataSpot System is
  175. intended for publishing and testing a databases on your computer.  It is limited
  176. to one user issuing queries at a time. The Production DataSpot System is
  177. intended for publishing databases on the internet or intranet, and is typically
  178. installed on a Web server computer. It allows multiple users to issue queries
  179. concurrently.
  180.  
  181.   As part of the DataSpot installation in Windows NT the DataSpot Server will
  182. be installed as a service in automatic startup mode. When installing on
  183. Windows 95, which has no services, you will be asked if you want the DataSpot
  184. Server to be started automatically when you boot your computer (the default).
  185.  
  186.   If the installation fails to configure a Web server to work with DataSpot
  187. Query Server, or if you wish to configure a Web server manually, follow the 
  188. instructions in "Configuring Web Servers" below.
  189.  
  190.   If the installation fails to configure SoftQuad's HoTMetaL Pro 4.0 editor to
  191. work with DataSpot template files, or if you wish to configure them manually,
  192. follow the instructions in "Configuring the HoTMetaL Pro 4.0 Editor" below.
  193.  
  194. WARNING REGARDING MANUAL INSTALLATION: If you manually configure a Web server
  195. or an editor and later uninstall DataSpot, you will need to
  196. manually undo these configurations.
  197.  
  198.   As part of the DataSpot installation the dtl\program directory is added
  199. to the PATH variable. However, if the setup program fails to set the PATH 
  200. you should do it manually. In Windows NT, go to the control panel / System 
  201. and select the Environment tab. Add the directory where dtl\program was 
  202. installed to the PATH variable. In Windows 95, edit the Autoexec.bat file
  203. and add the directory to the PATH= clause. Beware not to exceed the 
  204. default maximum length (128 characters). You should manually remove 
  205. unneeded entries from the PATH before adding DTL to it if the maximum
  206. length is reached.
  207. Note that the Netscape Enterprise Server appears to ignore the change to
  208. the PATH. As a result, after the installation the Netscape Enterprise Server 
  209. may fail to restart and give an error message such as "hbdispif.dll not found
  210. in ..." where ... is the old value (directory list) of the PATH variable.
  211. Rebooting the computer at the end of the installation should solve this problem.
  212.  
  213. * Uninstallation Notes
  214.  
  215.   The DataSpot uninstallation process sometimes fails to completely "undo" the 
  216. installation. The following are known problems:
  217.  
  218.     - Log files, such as "aso.log", "aso_err.log", "dispdll.log" are not removed.
  219.       Remove them manually.
  220.  
  221.     - The files hbdisp.dll and hbquery.dll are not removed. Make sure the 
  222.       DataSpot Server is stopped and then remove the files.
  223.  
  224.     - The files hbhext.dll, hbdispif.dll or hbadmin.dll are not removed.
  225.       Temporarily stop the Web server(s) configured to work with DataSpot Query
  226.       Server, remove the files, and restart the server(s).
  227.  
  228.     - Other files or directories under the DTL root directory are not removed.
  229.       Verify the specific files mentioned above have been removed, and then
  230.       retry. If that fails, try rebooting and then removing the files or
  231.       directories.
  232.  
  233.     - If a user aborts the uninstallation process and later on tries again to
  234.       uninstall DataSpot, the user may get an error message such as "Setup
  235.       requires _SETUP.DLL and _ISRES.DLL...". To correct this problem locate
  236.       the file _isres.dll in the installation directory (e.g. on the CD) and
  237.       copy it to the dtl\program\setup directory, and then try again.
  238.  
  239.     - The configuration of a Netscape Enterprise or FastTrack Server to work with
  240.       DataSpot Query Server is not undone, and the server may fail to start.
  241.       This is because the DataSpot entries in the "obj.conf" file associated with
  242.       the Netscape server were not removed -- see "To configure Netscape
  243.       Enterprise or FastTrack Server" below. Edit the "obj.conf" file and remove
  244.       the DataSpot entries (you can use the saved copy of the "obj.conf" file
  245.       created during the DataSpot installation if you haven't made changes to
  246.       your configuration since). Then use the Netscape Administration Server
  247.       (Server Selector) to load the modified "obj.conf" file and stop and then
  248.       start the server you configured. Alternatively in Windows NT you may open
  249.       Control Panel/Services and select the service associated with that server.
  250.       Stop the service and then start it.
  251.  
  252. =============================================================
  253.                     Configuring Web Servers
  254. =============================================================
  255.  
  256.   When DataSpot is installed, it presents a list of the installed Web servers
  257. and lets the user select the servers that should be configured to work with
  258. the DataSpot Query Server. However, if the automatic configuration fails, or if
  259. you install or upgrade a Web server after installing DataSpot, you can configure
  260. the Web server manually by following the instructions below (see WARNING
  261. REGARDING MANUAL INSTALLATION above).
  262.  
  263.   IMPORTANT: when following the instructions %DTL_HOME% should be replaced by
  264. the full path to the directory where DataSpot was installed (by default \dtl),
  265. %DTL_HOME_2% should be replaced by the same path with backward slashes replaced
  266. by forward slashes (e.g. /dtl).
  267.  
  268. * To configure Microsoft Internet Information Server or Personal Web Server:
  269.  
  270.   - Use the Internet Service Manager to create a virtual directory /DTL that 
  271.     points to the root directory of DataSpot: make sure the WWW service is
  272.     running and double-click on it (or select "Service Properties" from the
  273.     "Properties" menu). Select the "Directories" tab. Click "Add". In the
  274.     directory field enter or browse to %DTL_HOME%. Choose "Virtual Directory" 
  275.     and in the Alias field enter "DTL". Select both "Read" and "Execute" access.
  276.     Click OK and again OK.
  277.  
  278.   - Associate the ".adb" extension with the executable "hbhext.dll": run the
  279.     registry editor (regedt32.exe), open the key "\HKEY_LOCAL_MACHINE\SYSTEM\
  280.     CurrentControlSet\Services\W3SVC\Parameters\Script Map". Add a new value
  281.     whose name is ".adb", whose type is "REG_SZ", and whose string value is 
  282.     "%DTL_HOME%\program\hbhext.dll".
  283.  
  284.   To apply the changes, use the Internet Service Manager in NT or the Personal
  285. Web Server in 95 to stop and then start the WWW (HTTP) service. Alternatively
  286. in Windows NT open Control Panel/Services, select the World Wide Web Publishing
  287. Service, stop the service and then start it.
  288.  
  289. * To configure Netscape Enterprise Server or FastTrack Server:
  290.  
  291.   You need to modify the "obj.conf" configuration file for the server you wish
  292. to configure. The configuration files for server XXX are located in a directory
  293. named "config" a few levels below the directory where Netscape was installed
  294. (e.g. \Netscape). You can find the configuration directory by looking at the
  295. value of "ConfigurationPath" under the registry key for the server.
  296. For Netscape Enterprise Server version 2.0 the key is located under
  297. "\HKEY_LOCAL_MACHINE\SYSTEM\Software\Netscape\https-XXX", and for version 3.0 it
  298. is located under "\HKEY_LOCAL_MACHINE\software\Netscape\Enterprise\3.0\https30-XXX".
  299. For FastTrack Server version 2.0 the key is located under
  300. "\HKEY_LOCAL_MACHINE\SYSTEM\Software\Netscape\httpd-XXX".
  301.  
  302.   First, we suggest you save a copy of the "obj.conf" file. Next make sure the
  303. "obj.conf" is writable. Then make the following additions to the file.
  304.  
  305.   Immediately before the first occurrence of "<Object name=" in the file, add the
  306. following lines:
  307.  
  308. #DataSpot
  309. Init fn="load-modules" funcs="DataSpotRequest" shlib="%DTL_HOME_2%/PROGRAM/HBHEXT.DLL"
  310. Init fn="load-modules" funcs="DataSpotAdmin" shlib="%DTL_HOME_2%/PROGRAM/HBADMIN.DLL"
  311.  
  312.   (note that the path names, including %DTL_HOME_2%, should be specified using
  313. forward slashes).
  314.  
  315. # DataSpot
  316. <Object name="adb">
  317. PathCheck fn="nt-uri-clean"
  318. PathCheck fn="find-pathinfo"
  319. Service fn="DataSpotRequest"
  320. AddLog fn="flex-log" name="access"
  321. </Object>
  322.  
  323. <Object name="adb-admin">
  324. PathCheck fn="nt-uri-clean"
  325. PathCheck fn="find-pathinfo"
  326. Service fn="DataSpotAdmin"
  327. AddLog fn="flex-log" name="access"
  328. </Object>
  329.  
  330.   Immediately after the first occurrence of "<Object name=default" in the file,
  331. add the following lines:
  332.  
  333. #DataSpot
  334. NameTrans fn="assign-name" from="*.adb" name="adb"
  335. NameTrans fn="assign-name" from="*/hbadmin.dll" name="adb-admin"
  336. NameTrans from="/dtl" fn="pfx2dir" dir="%DTL_HOME_2%"
  337.  
  338. (note that the %DTL_HOME_2% should be specified using forward slashes).
  339.  
  340.   To apply the changes, use the Netscape Administration Server (Server Selector)
  341. to load the modified "obj.conf" file and stop and then start the server you
  342. configured. Alternatively in Windows NT open Control Panel/Services and select
  343. the service associated with that server. For a Netscape Enterprise Server
  344. https-XXX the Web service is called in version 2.0 "Netscape Enterprise Server
  345. https-XXX" and in version 3.0 "Netscape Enterprise Server 3.0 (XXX)". For
  346. a Netscape FastTrack Server httpd-XXX the Web service is called in version 2.0
  347. "Netscape FastTrack Server httpd-XXX". Stop the service and then start it.
  348.  
  349. * To configure ZBSoft's ZBServer Pro Server:
  350.  
  351.   - Use the ZBServer Log Manager to create a virtual directory /DTL that 
  352.     points to the root directory of DataSpot: select "Shared Folders..." from the
  353.     "Edit" menu. Click "Add Folder" button. Choose %DTL_HOME% directory (this will 
  354.     be automatically entered in the DOS path field). In the URL path field enter 
  355.     /dtl, and click on the CGI check box (in the "Allow" group). Click OK.
  356.     To apply the changes, restart the server.
  357.  
  358.   - Make sure the value of PURECGI under the 
  359.     "\HKEY_LOCAL_MACHINE\SYSTEM\Software\DTL\DataSpot\1.0" key is set to 1. 
  360.     This will enable DataSpot to operate in CGI mode (which is necessary 
  361.     e.g. for ZBSerevr).
  362.  
  363. =============================================================
  364.              Configuring the HoTMetaL Pro 4.0 Editor
  365. =============================================================
  366.  
  367.   When DataSpot is installed, it asks the user if the HoTMetaL Pro 4.0 editor
  368. should be configured to work with DataSpot template files. However, if the
  369. automatic configuration fails, or if you install or upgrade HoTMetaL after
  370. installing DataSpot, you can configure HoTMetaL manually by following the
  371. instructions below (see WARNING REGARDING MANUAL INSTALLATION above).
  372.  
  373. First you will need to register DTL's design-time control module for HoTMetaL,
  374. HBHMDTC.OCX. To register the OCX, open a command line window and type:
  375.  
  376. %DTL_HOME%\program\setup\regsvr32.exe  %DTL_HOME%\program\hbhmdtc.ocx 
  377.  
  378. This will register the OCX by adding a class-id key in the registry for each
  379. class defined in the OCX. The classes are registered under the keys:
  380. HKEY_CLASSES_ROOT\HBHMDTC.%Class%
  381. (Where %Class% is the class name, such as AnswerList, QueryForm etc.)
  382.  
  383. Now, for each class added in the registry, run the command:
  384.  
  385. %DTL_HOME%\program\setup\regsvrdc.exe  HBHMDTC.%Class%
  386.  
  387. When working with DataSpot Publisher select the "HoTMetaL Template" option from 
  388. the "Options" menu bar.
  389.  
  390. To check the HoTMetaL configuration for DataSpot, start the HoTMetaL Editor
  391. and open a document. Select from the "Insert" menu the "Design Time Control..."
  392. option. You should see various DataSpot items, such as query form and answer 
  393. rank, in the list of available components.
  394.  
  395. * Special Notes For HoTMetaL Pro 4.0 Users
  396.  
  397.   If you are using the HoTMetaL Pro 4.0 editor to edit template (.htx) files, 
  398. please pay attention to the following:
  399.  
  400.   - In order to line-up the SQ.DTC (SoftQuad Design Time Control) tags,
  401. go to any SQ.DTC tag (see display bar on lower-left corner of HoTMetaL editor 
  402. window). Select Tools / Display / Option / Modify... from the editor top menu 
  403. bar. Click the 'inline' radio button. This will change the display from a 
  404. block structure to an inline structure.
  405.   - The editor will display internal comments on the screen when updating and 
  406. adding DTCs. This is currently a normal behavior of HoTMetaL (the DTC enters 
  407. comments as if you had typed them in and thus HoTMetaL shows you these 
  408. comments). You need to refresh the document in order to hide the comments. One 
  409. way to refresh the document is to change from "WYSIWYG" view to an 
  410. "HTML-Source" view, and then to change back to "WYSIWYG" view mode.
  411.   - On slow machines the DTC response time may be long. Please wait until the 
  412. DTC is loaded.
  413.  
  414. =============================================================
  415.                       Running DataSpot
  416. =============================================================
  417.  
  418.   If you are using the Windows 95 Explorer shell (on NT server version 4.0 or
  419. higher), run the DataSpot programs from the "Programs\DTL Applications" menu.
  420. If you are using the Program Manager, (on NT 3.51), the DataSpot programs are 
  421. located in the "DTL Applications" group.
  422.  
  423. * Demos:
  424.  
  425. To test the DataSpot Query Server run the "DataPot Demos" program.
  426.  
  427.   When you execute the demo a Web browser should open and let you choose to 
  428. search one of two demo databases. One database contains information about 
  429. Washington State Wines and the other contains information about classified ads. 
  430. If the demo does not run properly make sure that the DataSpot Server and your
  431. Web server services are running (you can check that in NT by opening "Control 
  432. Panel/Services", and in Windows 95 by looking at the Taskbar), and then try
  433. again.
  434.  
  435. * DataSpot Publisher
  436.  
  437.   Use DataSpot Publisher to automatically integrate data from your data sources
  438. and construct a DataSpot Web View (.ADB) file and an associated display template
  439. (.HTX) file.
  440.  
  441. If you experience any problems see "Troubleshooting" below.
  442.  
  443. * DataSpot Query Server
  444.  
  445.   Use DataSpot Query Server to search and navigate a DataSpot Web View (.ADB)
  446. file. A user connects to the server by using a standard Web browser and
  447. specifying a URL that references the file to be explored (e.g. by following a
  448. link). If the DTL root directory is dtl-path (default \dtl) and the Web View
  449. file is located in \dtl-path\adb-path, (e.g. adb-path for the demo wine database
  450. is \sample\wines\wine.adb) then the URL should be http://HOST/dtl/adb-path?, 
  451. where HOST identifies your computer (e.g. a host name or an IP address), and 
  452. where adb-path is converted to forward slashes (e.g. /sample/wines/wine.adb); 
  453. note that the mapping from URL /dtl to directory dtl-path has already been taken 
  454. care of during installation. TIP: to access the server on the local computer you 
  455. can use the special IP address 127.0.0.1 (if your browser uses a proxy you need
  456. to set it such that the proxy is not used for local addresses such as 127.0.0.1).
  457.  
  458.   If you wish to use a Web server configured to work on port number NNN (e.g.
  459. if you have multiple Web servers on the computer), you should use a URL of the
  460. form //HOST:NNN/dtl/... Port 80 is the default and may be omitted.
  461.  
  462. If you experience any problems see "Troubleshooting" below.
  463.  
  464. =============================================================
  465.                      Troubleshooting
  466. =============================================================
  467.  
  468.   The following problems may occur when using DataSpot Publisher or DataSpot 
  469.   Query Server. We recommend that you check the "Frequently Asked Questions" page
  470.   in the DataSpot Web site (http://www.dataspot.com) for the latest updates to 
  471.   this list.
  472.  
  473. * DataSpot Publisher
  474.  
  475.     - Publisher error 3041 trying to read an MS Access MDB file. This may happen
  476.       because the associated DLL, msrd2x32.dll, was not registered, or because
  477.       of compatibility problems between the versions of MS Access used to create 
  478.       and to read the MDB file. Use regsvr32.exe to register the DLL, e.g. type 
  479.       the command "regsvr32.exe msrd2x32.dll". If the problem persists, try 
  480.       compacting the MDB file. This can be done using MS Access or ODBC (through 
  481.       Control Panel/ODBC/Add/Compact).
  482.  
  483.     - Publisher error 3170 ("Couldn't find installable ISAM") trying to read a 
  484.       DBF (or other) file. This happens because the associated DLL, e.g. 
  485.       msxb3032.dll, was not registered. Use regsvr32.exe to register the DLL,
  486.       e.g. type the command "regsvr32.exe msxb3032.dll".
  487.  
  488.     - Generator error 2: out of heap space. 
  489.       Geneartor error 1103: out of disk space.
  490.       These errors happen when the generator cannot allocate necessary buffer space, 
  491.       usually since there is not enough free space on the disk. Free some disk space 
  492.       and try again.
  493.  
  494.       NOTE: During the generation process, the generator creates a temporary working 
  495.       directory. If the Generator's input file is XXX.DSP, located in directory DDD,
  496.       then the temporary working directory is located under DDD and is named XXX.$0$.
  497.       DataSpot Version 1.2 uses either the TMP or TEMP environment variables (in 
  498.       this order) to determine another temporary directory used for various sort files
  499.       created during the generation of DataSpot Web View (.ADB file). If neither of 
  500.       these variables are defined, the genarator uses the above temporary working 
  501.       directroy to store also the temporary sort files.
  502.       Make sure that if either the TMP or TEMP variables are defined, they point to 
  503.       a valid directory with sufficient disk space. Moreover, placing the temporary 
  504.       directory in a different disk drive may imrove the Generator's performance.
  505.  
  506.     - Generator error 48: Error in loading DLL (hbconv)
  507.       (This error may be trailed by a few other errors as well.)
  508.       This error happens when the generator cannot find neccessary ODBC files. To 
  509.       correct this, install ODBC32 Administrator.
  510.  
  511. * DataSpot Query Server
  512.  
  513.     - "Object Module not found": see if either hbhext.dll or hbdispif.dll are
  514.       missing from the dtl\program directory.
  515.  
  516.     - The Microsoft Internet Information Server returned an unrecognized
  517.       response or "file contains no data". This problem  may occur on a first
  518.       reference to a URL and is usually fixed simply by reloading (refreshing).
  519.       You can also try clearing the browser's disk and memory caches and then
  520.       reloading.
  521.  
  522.       If the problem persists, stop the Web server and reinstall the Dataspot
  523.       Query Server as follows. Open a command (DOS) window, change directory
  524.       to the \dtl\program directory, and type the following four commands:
  525.  
  526.       hbsvc.exe stop
  527.       hbsvc.exe remove
  528.       hbsvc.exe install
  529.       hbsvc.exe start
  530.  
  531.       Then close the command window and restart the Web server.
  532.  
  533.     - "Cannot connect to DataSpot server": verify that the DataSpot Server is
  534.       started.
  535.  
  536.     - "Connection Timeout": verify that the Web server you are using (on the
  537.       specified port, or default port "80" if none is specified) is running.
  538.       In Windows 95 the Server would be accessible from the task bar or the
  539.       start menu.  In Windows NT the server would likely be a service listed
  540.       under "Control Panel/Services".  For the Microsoft Internet Information
  541.       Server the Web service is called "World Wide Web Publishing Service".
  542.       For a Netscape Enterprise Server https-XXX the service is called in
  543.       version 2.0 "Netscape Enterprise Server https-XXX" and in version 3.0 
  544.       "Netscape Enterprise Server 3.0 (XXX)". For a Netscape FastTrack Server
  545.       httpd-XXX the Web service is called in version 2.0 "Netscape FastTrack
  546.       Server httpd-XXX". Stop the service and then start it.
  547.  
  548.     - Could not open file: verify that the URL for the ADB starts with 
  549.       "http://", not with "file://"
  550.  
  551.     - "File not found": verify that the URL for the ADB correctly points to the 
  552.       file. If the URL is http://.../dtl/adb-path/xxx.adb?, and if /dtl is mapped
  553.       to directory dtl-path, then the ADB file should be in 
  554.       \dtl-path\adb-path\xxx.adb (where adb-path is converted to backward 
  555.       slashes).
  556.  
  557.     - "Template file missing or incorrect": See if there is a template file
  558.       collocated with the ADB file. I.e. if the URL refers to file xxx.adb,
  559.       there should be a template file xxx.htx in the same directory. If the file
  560.       is there and has read permission, see if its syntax may be incorrect.
  561.  
  562.     - Netscape error: "There was no response. The server could be down or is 
  563.       not responding..." OR Microsoft IIS error: "Internet Explorer cannot open 
  564.       the Internet site http://127.0.0.1/dtl/defautlt.htm..." when running  
  565.       DataSpot DEMOS with ZBServer. This happens since ZBServer does not recognize 
  566.       "127.0.0.1" or "localhost" as valid URLs. Use your machine IP address instead.
  567.       e.g. open the URL: http://<IP Address>:<ZBServer Port>/dtl/default.htm in your
  568.       internet browser to access the DataSpot demos.
  569.  
  570.     - "Session time out": This error usually informs you that the query session has 
  571.       timed out. You can simply start a new query. However, when working with
  572.       DataSpot Development System (the default in Windows NT and a must in Windows 95) 
  573.       with two or more users simultaneously, this error indicates that only one user 
  574.       is allowed.
  575.  
  576. =============================================================
  577.                      Improving Publisher Performance
  578. =============================================================
  579.  
  580.  
  581. In order to improve the performance of the publishing process on Windows/NT, 
  582. you should do the following:
  583.  
  584. 1.  Stop the DataSpot Server.
  585.     You can use the DataSpot Server Manager to stop the DataSpot Server.
  586.     You can also run "Control Panel/Services", select the DataSpot Server
  587.     service and stop it.
  588.  
  589. 2.  From the Control Panel, select the Network dialog box and click the 
  590.     Services tab. Select the Server Network Service, and click the Properties 
  591.     button. Set the Optimization option to 'Maximize Throughput for Network 
  592.     Applications' (typically set to 'Maximize Throughput for File Sharing').
  593.  
  594. 3.  From the Control Panel, select the System dialog box and click the 
  595.     Performance tab. Set the Virtual Memory value by clicking the Change 
  596.     button and setting the 'Initial Size' of the 'Paging File Size for 
  597.     selected Drive' to the value displayed for 'Minimum Allowed' (typically
  598.     2MB) of 'Total Paging Size for All Drives'. Click the Set button.
  599.  
  600. 4.  For DataSpot version 1.1:
  601.  
  602.     Set the NUM_BUFFER_BLOCKS key in the DTL/DataSpot/1.0 registry to be 
  603.     as follows:
  604.  
  605.     Computer Memory (MB)     NUM_BUFFER_BLOCKS value
  606.           32                        0x1000 (4MB)
  607.           40                        0x1000 (4MB)
  608.           48                        0x1500 (6MB)
  609.           64                        0x2000 (8MB)
  610.          128                        0x6000 (24MB)
  611.  
  612.  
  613.     For DataSpot version 1.2:
  614.  
  615.     Set the NUM_BUFFER_BLOCKS key in the DTL/DataSpot/1.0  registry to be 
  616.     as follows:
  617.  
  618.     Computer Memory (MB)     NUM_BUFFER_BLOCKS value
  619.           32                        0x3000 (10MB)
  620.           40                        0x4000 (12MB)
  621.           48                        0x5000 (16MB)
  622.           64                        0x8000 (24MB)
  623.          128                        0xF000 (48MB)
  624.  
  625. 5.  Restart the DataSpot Server.
  626.     You can use the DataSpot Server Manager to start the DataSpot Server.
  627.     You can also run "Control Panel/Services", select the DataSpot Server
  628.     service and start it.
  629.  
  630. =============================================================
  631.                         Contacting DTL
  632. =============================================================
  633.  
  634. Phone:      +972-3-647-1661
  635. Fax:        +972-3-647-3717
  636. Email:      support@dtl.co.il
  637. Internet:   http://www.dataspot.com or http://www.dtl.co.il
  638.